home *** CD-ROM | disk | FTP | other *** search
/ Aminet 41 / Aminet 41 (2001)(Schatztruhe)[!][Feb 2001].iso / Aminet / text / misc / Checker0v5.lha / Checker / OldSoftware / opis_sîownikav1_25 < prev    next >
Text File  |  2000-11-18  |  30KB  |  706 lines
  1.  
  2.                Od Autora!!!
  3.  
  4.  
  5.     Program ten jest obecnie w peîni darmowy, powstaî jako praca
  6. dyplomowa jakieô 6 lat temu w Zespole  Szkóî  Elektrycznych  im.  T.
  7. Koôciuszki w Opolu. Po leûaî sobie trochë po tym jak zostaî napisany
  8. zanim postanowiîem udostëpniê go drugim.
  9.  
  10.  
  11. A to mój adres domowy:         47-100 Strzelce Opolskie
  12.                                 ul. K Wyszyïskiego 8/34
  13.                                    Jarosîaw Paruzel.
  14.  
  15.  
  16.  
  17.     Sam  program  w  swej  pierwotnej  formie  powstaî na doôê
  18. archaicznym asemblerze jakim byî Master Seka, jednakûe obecna jego
  19. wersja  zostaîa  przystosowana  do asemblacji jedynie pod ASM One.
  20. Wiâûe  sië  to  z  wykorzystaniem  w  kodzie  úródîowym  INCLUDÓW.
  21. Podczas ûmudnej konwersji kodu Úródîowego mogîo dojôê do powstania
  22. bîëdów  które  sâ  bardzo  trudne do wykrycia, jeûeli wiëc podczas
  23. uûywania  tego  programu  na trafisz na jakiekolwiek problemy bëdë
  24. wdziëczny  o  ich  poinformowaniu mnie, dziëki temu ty przy czynisz
  25. sië do do mej mobilizacji w ich usuwaniu.
  26.  
  27.     ps:    pozdrowienia   dla   wszystkich   Amigowców   a   w
  28. szczególnoôci  dla Amigantek oraz ludzi z IRC.  Niech moc bëdzie z
  29. nami!!!!!!!!!!!!!
  30.  
  31. Create2_3  -  sîuûy  do  îâczenia  dodatkowej   biblioteki   wyrazów
  32. z  bibliotekâ  gîówna,  poprostu  uruchom  program  i  poczekaj   na
  33. zakoïczenie    pracy,    nastëpnie    usuï     rëcznie     dodatkowa
  34. bibliotekë wyrazów. Pamiëtaj im wiëksza dodatkowa biblioteka wyrazów
  35. tym wolniejsza praca programu.
  36.  
  37.  
  38.  
  39. Historia programu:
  40. - 1.2 Pierwsza wersja ogólnodostëpna, po raz pierwszy zamieszczona
  41. przeze  mnie  w  aminecie,  niestety  posiadaîa pewien bîâd, który
  42. objawiaî  sië  tym  iû  po przeîâczeniu w preferencjach na pozycje
  43. otwierania  okienka  programu  na  ekranie  workbencha a nastëpnie
  44. wybranie funkcji ZAPISZ lub UÛYJ powodowaîo zawieszenie programu.
  45.  
  46. -  1.21  Wyeliminowanie bîëdu z wersji 1.2, dodatkowo zastosowanie
  47. funkcji   RawKeyConvert   z   console.devices,  poprawiîo  obsîugë
  48. programu  z  poziomu klawiatury (dostosowanie do kaûdego obîoûenia
  49. klawiatury).
  50.  
  51. -  1.25  Poprawiono  sprawdzanie  tekstów z poziomu Orto_Slownika,
  52. dziëki  czemu  program rozpoznaje teraz wyrazy dzielone myôlnikiem
  53. îâczâc  je w jednâ caîoôê, dodano obsîugë clipboardu, moûesz teraz
  54. bez problemowo   przenosiê  teksty  pomiëdzy  sîownikiem  a  innymi
  55. programami  obsîugujâcymi  clipboard.   Wbudowano w program menu z
  56. dostëpnymi  21  popularnymi  na  róûnych  platformach  standardami
  57. kodowania  polskich  znaków, nie trzeba ich teraz wpisywaê rëcznie
  58. moûna  je  wybraê  kilkoma  ruchami  myszki.   Dodano kilka nowych
  59. funkcji  arexx-owych.   Wprowadzono kilka niezauwaûalnych zmian, w
  60. samym  kodzie úródîowym które czyniâ program bardziej 'przyjaznym'
  61. dla  systemu  operacyjnego.  Wprowadzono 4 Kb buforu w pamiëci ram
  62. dla nowo dodawanych wyrazów, dziëki czemu rzadziej teraz wykonywane
  63. sâ operacje zapisu przy dodawaniu nowych wyrazów. 
  64.  
  65. Dostëpna jest jedna gîówna biblioteka z wyrazami, zapisana pod nazwâ
  66. BigOrtLib zawierajâca w sobie ponad  250.000  wyrazów,  przeznaczona
  67. jest ona wyîâcznie dla posiadaczy twardych dysków, ze wzglëdu na swâ
  68. objëtoôê okoîo 3.0MB bajtów.
  69.  
  70.  
  71. - 2.00 usuniëto  wiëkszoôê  bîëdów,  przyspieszono  pracë  programu.
  72. Poprawiono program  Create_new_Dictonary,  jest  on  teraz  o  wiele
  73. szybszy niû poprzednik. Program staî sië caîkowicie darmowy. Jest to
  74. jednoczeônie jego ostatnia wersja...
  75.  
  76. JEDNAKÛE  NIE  MOGË  ZAGWARANTOWAÊ  ÛE  JEST TO WERSJA BEZ ÛADNYCH
  77. BÎËDÓW,  SZCZEGÓLNIE TYCH MIESZCZÂCYCH SIË W BIBLIOTEKACH WYRAZÓW,
  78. NIE  PONOSZË  WIËC  ÛADNEJ  ODPOWIEDZIALNOÔCI  ZA  WSZELKIE PAÎY Z
  79. JËZYKA   POLSKIEGO  KTÓRE  TY  MOÛESZ  OTRZYMAÊ,  SPRAWDZAJÂC  SWE
  80. WYPRACOWANIA, ZADANIA DOMOWE I INNE PLIKI TEKSTOWE TYM PROGRAMEM.
  81.  
  82. JEÔLI  NATOMIAST ZAUWAÛYSZ JAKÂKOLWIEK NIEPRAWIDÎOWOÔÊ W DZIAÎANIU
  83. PROGRAMU  (GURU  MESAGES), DAJ MI O TYM NIEZWÎOCZNIE ZNAÊ.  Z GÓRY
  84. DZIËKUJË.  :)
  85.  
  86.  
  87. ******************************************************************
  88. ******************************************************************
  89.  
  90.  
  91.  
  92.  
  93.                               Wstëp.
  94.  
  95.  
  96.     Program Orto_Sîownik powstaî z myôlâ o wszystkich polskich
  97. uûytkownikach  Amigi  oraz  dostëpnych  dla niej edytorów tekstów.
  98. Piszâc  teksty  na  komputerze  i  nie  tylko  popeîniamy bîëdy im
  99. dîuûszy  tekst, tym wiëcej okazji do popeînienia bîëdu.  Bîâd moûe
  100. byê  ortograficzny  lub  interpunkcyjny,  moûemy przestawiê litery
  101. ('czeski  '  bîâd), opuôciê je lub dodaê piszâc zbyt szybko.  Jest
  102. jeszcze  parë  moûliwoôci,  ale  tak czy owak, zawsze po napisaniu
  103. tekstu  trzeba  przystâpiê  do  jego  korekty.  W wypadku krótkich
  104. tekstów sprawa jest stosunkowo prosta, ale przy dîuûszych robi sië
  105. z  tego  problem.   I  tu  wîaônie przychodzi nam z pomocâ program
  106. Orto_Sîownik,  przy  pomocy  którego dany tekst moûemy sprawdziê w
  107. sposób wygodny i szybki.
  108.  
  109.                      Informacje o programie.
  110.  
  111.     W  obecnej  wersji programu, doîâczona do niego biblioteka
  112. wyrazów   liczy  okoîo  250.000  wyrazów,  jednakûe  w  samym
  113. programie mamy moûliwoôê rozbudowy tej biblioteki.
  114.     Ôredni czas sprawdzenia pojedynczego wyrazu zaleûy od tego
  115. gdzie  znajduje sië biblioteka z wyrazami oraz od prëdkoôci samego
  116. komputera, i wynosi on 0.026 sekundy dla biblioteki umieszczonej w
  117. pamiëci  CHIP RAM, dla komputera Amiga 500 z procesorem MC 68000/7
  118. Mhz.   Po  odpowiednich przeliczeniach daje to okoîo 38 wyrazów na
  119. sekundë.
  120.     Podkreôlenia  wystëpujâce  w  opisie  gadûetów,  oznaczajâ
  121. klawisz który moûemy wcisnâê z klawiatury zamiast wciskania samego
  122. gadûetu myszkâ.
  123.  
  124.                        Wymagania sprzëtowe.
  125.  
  126.     Orto_Sîownik  do  swej  pracy  wymaga   Amigë   z   systemem
  127. operacyjnym  1.3  lub  wyûszym  oraz  minimalnie  512   kB   pamiëci
  128. operacyjnej, jednak peîny komfort  pracy  uzyskuje  sië  przy  3  MB
  129. pamiëci operacyjnej lub dysku twardym. Jako dodatek proponowany jest
  130. edytor tekstów  wyposaûony  w  interfejs  arexx-a.  Uûywana  obecnie
  131. przeze mnie konfiguracja to Amiga z systemem operacyjnym 3.0,  8  MB
  132. pamiëci  fast,  oraz  edytor  tekstów  Ced  v2.12,  dla  którego  to
  133. dodatkowo  stworzyîem  odpowiednie  skrypty  arexx-owe.   Dysponujâc
  134. natomiast  bibliotekâ  reqtools.library,  zalecane   jest   aby   jâ
  135. skopiowaê do  katalogu  libs  dyskietki  Orto_Sîownika,  wówczas  to
  136. w programie uûyty zostanie  filerequest  do  wyboru  pliku  z  tejûe
  137. biblioteki, co dodatkowo podniesie komfort pracy z programem.
  138.  
  139.  
  140.                       Uruchomienie programu.
  141.  
  142.         Po   wîâczeniu   komputera,   wkîadamy  do  stacji  dysków
  143. dyskietkë  z  programem.   Po  zaîadowaniu  i  ukazaniu sië ekranu
  144. WORKBENCH-a,  wybieramy  z  niego  ikonkë dyskietki Orto_Sîownik (
  145. kierujâc  wskaúnik  myszki  tak  aby znalazî sië on nad ikonkâ, po
  146. czym  przyciskamy  dwukrotnie  lewy przycisk myszki), spowoduje to
  147. otwarcie  sië  okienka  dyskietki,  w którym to powinny ukazaê sië
  148. ikonki  umieszczonych na niej programów.  Nastëpnie z okienka owej
  149. dyskietki   wybieramy   ikonkë  programu  Sîownik  (tak  samo  jak
  150. wybieraliômy  ikonkë  dyskietki).   Po  tych operacjach na ekranie
  151. WORKBENCH-a   powinna  ukazaê  sië  belka  programu  opisana  jako
  152. 'Orto_Slownik'.
  153.  
  154.     By  z  owej  belki  rozwinëîo sië peîne okienko, naleûy jâ
  155. uaktywniê (kierujâc w jej kierunku wskaúnik myszki tak aby znalazî
  156. sië on nad niâ, nastëpnie naleûy przycisnâê lewy przycisk myszki),
  157. po  czym  przyciskamy  prawy  przycisk  myszki  lub klawisz DEL na
  158. klawiaturze.   Ponowne  wykonanie tej operacji spowodujë przejôcie
  159. owego okienka do stanu poprzedniego (belki).
  160.  
  161.  
  162.                         Obsîuga Programu.
  163.  
  164.     W  Orto_Slowniku  mamy  do  dyspozycji kilka trybów pracy,
  165. jako  pierwszy  przedstawië  tryb  bezpoôredni.   Tryb  ten moûemy
  166. porównaê  do nastëpujâcej sytuacji:  przypuôêmy ûe podczas pisania
  167. tekstu  nie  jesteômy  pewni jak napisaê dany wyraz.  Mamy wówczas
  168. dwie   moûliwoôci,   skorzystaê   z  konwencjonalnego  ksiâûkowego
  169. sîownika wertujâc kolejne kartki w poszukiwaniu danego wyrazu, lub
  170. skorzystaê  z  programu,  który  to z racji swego dziaîania za nas
  171. poszuka   danego   wyrazu   w   swej  bibliotece  i  to  w  czasie
  172. nieporównywalnie  krótszym  od  tego  jaki  potrzebny  by  byî  do
  173. odszukania tego samego wyrazu przez nas w ksiâûce.
  174.  
  175.                       Wyszukiwanie wyrazów.
  176.  
  177.     Celem   odszukania   interesujâcego   nas   wyrazu  naleûy
  178. uaktywniê  gadûet tekstowy (kierujâc w jego stronë wskaúnik myszki
  179. tak aby znalazî sië on nad nim samym, po czym naleûy nacisnâê lewy
  180. przycisk  myszki,  lub  po prostu wciskamy klawisz ENTER) tak by w
  181. nim  ukazaî  sië nam kursor sygnalizujâcy gotowoôê do pracy, teraz
  182. to   moûemy   wpisaê  interesujâcy  nas  wyraz,  zatwierdzajâc  go
  183. klawiszem   ENTER.   Po  tej  to  operacji  program  przystâpi  do
  184. odszukania owego wyrazu w swej bibliotece.
  185.  
  186.         W przypadku gdy szukany wyraz zostanie odnaleziony program
  187. wydrukuje  go  dodatkowo  w  swym okienku , w przeciwnym natomiast
  188. razie   na  ekranie  zostanie  wyôwietlony  programowy  REQUEST  z
  189. pytaniem czy szukany wyraz ma zostaê dodany do biblioteki programu
  190. by od tej pory byî uwaûany za poprawny czy teû nie.
  191.  
  192. Wybierajâc  z  owego  REQUEST-u  gadûet 'Tak' (ewentualnie klawisz
  193. ENTER lub T z klawiatury) zgadzamy sië na dodanie szukanego wyrazu
  194. do  biblioteki  programu,  wciskajâc  natomiast  gadûet 'Nie' (lub
  195. dowolny  inny  klawisz  z  klawiatury)  nie  zgadzamy  sië  na  të
  196. operacjë.
  197.  
  198.     Szukajâc   przykîadowo  wyrazu  'który'  podajâc  go  jako
  199. 'ktury' program stwierdzi iû nie ma go w swej bibliotece, by teraz
  200. caîkowicie  upewniê  sië ûe wyraz 'ktury' nie tylko nie istnieje w
  201. bibliotece  programu  ale równieû nie pisze sië przez 'ktury' lecz
  202. przez 'który', naleûaîoby poszukaê go ponownie jako 'który'.  Caîa
  203. ta  operacja nie byîaby zbyt wygodna w uûyciu, lepiej bowiem w tym
  204. celu  zastâpiê  niewiadomâ  literkë (w tym przypadku 'ó') jednym z
  205. nastëpujâcych  jokerów:   '?'  lub  '*', których to znaczenie jest
  206. nastëpujâce:
  207.  
  208. '?'  - zastëpuje dowolny pojedynczy znak.
  209.  
  210. '*' - zastëpuje dowolny ciâg znaków.
  211.  
  212. Uûywajâc   teraz   w  wyrazie  'który'  jokerów  moûemy  podaê  go
  213. programowi  jako  'kt?ry', dla peînego i jasnego zrozumienia podam
  214. jeszcze kilka przykîadów wraz z ich interpretacjâ przez program.
  215.  
  216. 'ad*' - program wyôwietli wszystkie wyrazy zaczynajâce sië na 'ad'
  217. takie jak np:  'Adama', 'adamaszek, 'adaptacja'.
  218.  
  219. 'po*t'  -  program  wyôwietli  wszystkie wyrazy zaczynajâce sië na
  220. 'po' które dodatkowo koïczâ sië na 't' np:  'pobyt', 'poczet'.
  221.  
  222. 'ba*l*'  -  program  wyôwietli wszystkie wyrazy zaczynajâce sië na
  223. 'ba' w których dodatkowo musi wystëpowaê literka 'l' np:'Babilon',
  224. 'babsztyl', 'badyl', 'bagatela'.
  225.  
  226. 'mr?z*'  -  program  wyôwietli wszystkie wyrazy zaczynajâce sië na
  227. 'mr', dodatkowo  w wyrazach tych czwartym znakiem musi byê 'z' np:
  228. 'mrozów', 'mrozy', 'mróz'.
  229.  
  230. '*óg'  -  program  wyôwietli wszystkie wyrazy koïczâce sië na 'óg'
  231. np:  'barîog','Bóg','dróg','gîóg','naîóg'.
  232.  
  233. Nie  naleûy  natomiast  stosowaê  dwóch  wystëpujâcych obok siebie
  234. jokerów   np:'**','*?','?*',  poniewaû  poîâczenie  takie  nie  ma
  235. logicznego sensu.
  236.  
  237.  
  238.     W   okienku  programu  maksymalna  iloôê  do  wyôwietlenia
  239. jednoczeônie  wyrazów  to  10,  w  przypadku gdy odnaleziona iloôê
  240. wyrazów  bëdzie  wiëksza  niû owe 10 to i tak wyôwietlone zostanie
  241. tylko  dziesiëê  pierwszych,  do  pozostaîych  mamy  jednak dostëp
  242. stosujâc odpowiednie przewijanie.
  243.  
  244. a)  Naciskajâc  myszkâ  gadûet  ze  strzaîkâ  w  dóî lub klawisz z
  245. klawiatury ze strzaîkâ w dóî powodujemy przewiniëcie o jeden wyraz
  246. naprzód.
  247.  
  248. b)  Naciskajâc  myszkâ  gadûet  ze  strzaîkâ  w górë lub klawisz z
  249. klawiatury  ze  strzaîkâ  w  górë  powodujemy przewiniëcie o jeden
  250. wyraz wczeôniej.
  251.  
  252. Naciskajâc  dodatkowo  klawisz  SHIFT, powodujemy przewijanie o 10
  253. wyrazów naprzód lub wstecz.
  254.  
  255. UWAGA  wpisujâc  w  polu gadûetu samâ * spowodujemy odnalezienie i
  256. wyôwietlenie tylko pierwszych 1000 wyrazów, pozostaîe bëdâ ale nie
  257. bëdziemy  mieli  do  nich  dostëpu,  jest to wynikiem ograniczenia
  258. pamiëciowego jakie wprowadziîem.
  259.  
  260.  
  261.     Kolejnym trybem pracy programu jest sprawdzenie caîego lub
  262.                   wybranych fragmentów  tekstu.
  263.  
  264. Aby przejôê w ten tryb pracy programu naleûy wcisnâê myszkâ gadûet
  265. 'E',  wciôniëcie  owego  gadûetu  spowoduje otwarcie sië kolejnego
  266. okienka   z  szeregiem  dostëpnych  dodatkowych  gadûetów.   Chcâc
  267. sprawdziê  dany  tekst  naleûy  go  najpierw  wczytaê do programu,
  268. wciskajâc  w  tym  celu gadûet 'Otwórz'.  Wciôniëcie owego gadûetu
  269. spowoduje  ukazanie  sië  REQUEST-u  proszâcego  o podanie ôcieûki
  270. dostëpu  do pliku z tekstem.  Po podaniu ôcieûki dostëpu do pliku,
  271. program  dokona  próby otwarcia go a nastëpnie wczytania.  Gdy owa
  272. operacja  przebiegnie pomyôlnie wczytany tekst powinien ukazaê sië
  273. w okienku, z tym ûe naraz moûe zostaê wyôwietlone tylko 20 linijek
  274. z  poôród  wszystkich w tekôcie.  Do pozostaîej treôci tekstu mamy
  275. dostëp   stosujâc   odpowiednie   przewijanie,   analogicznie  jak
  276. przy przewijaniu wyrazów.
  277.  
  278.     Chcâc   teraz   tekst   ten  poddaê  operacji  sprawdzenia
  279. naleûaîoby   najpierw   zaznaczyê   z   niego  wybrany  fragment,
  280. ewentualnie caîoôê.  Dokonaê tego moûemy w nastëpujâcy sposób.
  281.  
  282. a) kierujemy wskaúnik myszki na interesujâcâ nas linijkë tekstu
  283.  
  284. b)  nastëpnie  przyciskamy lewy przycisk myszki nie puszczajâc go,
  285. po  czym  to  moûemy:   przesuwaê  wskaúnik  myszki  w  dóî  chcâc
  286. zaznaczyê  kolejne  linijki  tekstu.   Puszczajâc  przycisk myszki
  287. koïczymy opcjë zaznaczania.
  288.  
  289.     Chcâc  szybko  zaznaczyê  caîy tekst naleûy wcisnâê gadûet
  290. 'Zaznacz',  natomiast  chcâc  szybko  wymazaê  zaznaczenie  naleûy
  291. wcisnâê gadûet 'Wyczyôê'.
  292.  
  293.     Zaznaczony   fragment   tekstu   bëdzie   podôwietlony  na
  294. niebiesko.
  295.  
  296.     Majâc  juû  zaznaczony  fragment  tekstu,  wciskamy gadûet
  297. 'Sprawdú',  by program mógî przystâpiê do sprawdzania zaznaczonego
  298. tekstu,  sprawdzajâc  po  kolei wyraz za wyrazem.  W przypadku gdy
  299. któryô  wyraz  z  tekstu  nie  zostanie  odnaleziony  w bibliotece
  300. programu,  na  ekranie  ukaûe  sië request z informacjâ, iû danego
  301. wyrazu   nie  odnaleziono.   Dodatkowo  z  poziomu  tego  requestu
  302. bëdziemy mogli dokonaê wyboru kilku funkcji.
  303.  
  304. a)  dodaê  wyraz  ten  do  biblioteki  programu  wciskajâc  gadûet
  305. 'Dodaj'.
  306.  
  307. b)  poszukaê  samemu  jakiegoô  innego  odpowiednika  by  go potem
  308. wymieniê z wyrazem bîëdnym.  Aby tego dokonaê naleûy:
  309.  
  310. 7-  wpisaê  nowy  wyraz  w  gadûecie tekstowym tak samo jak to jest
  311. opisane dla trybu bezpoôredniego.
  312.  
  313. - wcisnâê gadûet 'Szukaj'
  314.  
  315. -  w przypadku gdy szukaliômy wyrazu uûywajâc do tego celu jokerów
  316. i  program  odnajdzie jakieô odpowiedniki, moûemy wówczas z poôród
  317. nich  wybraê  ten  który  uwaûamy  za odpowiednik wyrazu bîëdnego,
  318. kierujâc  w jego stronë wskaúnik myszki, by nastëpnie wcisnâê lewy
  319. przycisk  myszki.  Wciôniëcie lewego przycisku myszki spowoduje iû
  320. wyraz  znajdujâcy  sië  pod  wskaúnikiem  myszki  ukaûe sië w polu
  321. gadûeta tekstowego, tak jak gdyby zostaî przez nas tam wpisany.
  322.  
  323. -  wciskamy  nastëpnie  gadûet 'Wymieï', by program wymieniî wyraz
  324. bîëdny na nowy.
  325.  
  326. -   chcâc   natomiast   przywróciê  wyraz  bîëdny  w  pole  gadûeta
  327. tekstowego,  naleûy  wcisnâê  gadûet 'I'.
  328.  
  329. - wciôniëcie gadûetu '<', powoduje iû w miejscu ostatniego znaku w
  330. wyrazie  szukanym  pojawi  sië  joker '*'.
  331.  
  332. c) wpisaê poprawnâ formë i wymieniê jâ z bîëdnâ.
  333.  
  334. -  wpisujâc poprawnâ formë w polu gadûeta tekstowego.
  335.  
  336. - wciskajâc gadûet 'Wymieï'.
  337.  
  338. d) zignorowaê komunikat programu wciskajâc gadûet 'Pomiï'.
  339.  
  340.     Przerwaê  operacje  sprawdzania  moûemy  dokonaê wciskajâc
  341. na staîe gadûet 'Zatrzym'.
  342.  
  343.     Gdy program sprawdzi caîy tekst a my dokonamy odpowiednich
  344. poprawek,  naleûaîoby  tak poprawiony tekst nagraê na dyskietkë,
  345. celem  utrwalenia,  by  tego  dokonaê  wciskamy gadûet 'Zapisz', i
  346. podajemy  nazwë  urzâdzenia  oraz  nazwë  pliku  w którym zostanie
  347. zapisana poprawiona wersja tekstu.
  348.  
  349. Dodatkowo  w  wersji  programu 1.25 mamy do dyspozycji 3 dodatkowe
  350. gadûety.
  351.  
  352. 'Wstaw'  -  wstawia  tekst  z  clipboardu  do programu, dostëpne z
  353. klawiatury po wciôniëciu klawisza 't' lub 'v'.
  354. Uwaga  -  funkcja  ta caîkowicie kasuje poprzedni tekst znajdujâcy
  355. sië w programie.
  356.  
  357. 'Kopiuj'  -  kopiuje  caîy  tekst  znajdujâcy  sië  w programie do
  358. clipboradu,  dostëpne  z klawiatury po wciôniëciu klawisza 'k' lub
  359. 'c'.
  360.  
  361. 'Zmieï  A'  -  pozwala  na  szybkâ  zamianë  standardu  kodowania
  362. polskich  znaków  bez  koniecznoôci  przechodzenia  do preferencji
  363. programu.   Szczególnie  przydatne gdy po wczytaniu tekstu okazuje
  364. sië  ûe  zamiast  polskich znaków mamy jakieô dziwne 'krzaczki' na
  365. ekranie.
  366.  
  367. "Dodaj  W"  -  wciôniëcie tego gadûetu sprawia, ûe program podczas
  368. sprawdzania  bloku  tekstu  (lub  caîego  tekstu) kaûdy nowy wyraz
  369. nieistniejâcy    dotychczas    w    bibliotece    programu   doda,
  370. automatycznie,  do  wyûej wspomnianej biblioteki nie pytajâc sië o
  371. potwierdzenie.    Funkcja   przydatna   wówczas   gdy  uzupeîniamy
  372. bibliotekë programu.
  373.  
  374.  
  375.  
  376.     Wyjôcia  z  trybu  sprawdzania  caîych  tekstów dokonujemy
  377. wciskajâc gadûet 'Pomiï'.
  378.  
  379.                    Orto_Sîownik a preferencje.
  380.  
  381.     W  programie  Orto_Sîownik  moûemy dokonaê dodatkowo zmian
  382. ustawieï niektórych preferencji.
  383.  
  384. 1)  zmieniê font (czcionkë) uûywany przez program na dowolny inny,
  385. przez podanie jego nazwy.  Jednakûe musi to byê font o wysokoôci 8
  386. punktów.   Jeôli  posiadamy  bibliotekë  reqtools  to wyboru moûna
  387. bëdzie dokonaê z menu z dostëpnymi fontami.
  388.  
  389. 2)  ustaliê  gdzie  znajduje sië podstawowa biblioteka wyrazów dla
  390. programu.    Podajâc   peînâ   ôcieûkë   dostëpu   do   niej   np:
  391. 'df0:ort_lib'. Wyboru moûna dokonaê takûe przez wybór odpowiedniego
  392. pliku z filerequesta dostëpnego w reqtools library.
  393.  
  394. 3)  ustaliê  gdzie  znajduje  sië dodatkowa biblioteka wyrazów dla
  395. programu.    Podajâc  peînâ  ôcieûkë  dostëpu  do  niej.   Do  tej
  396. biblioteki  program  bëdzie  dopisywaî  nowe  wyrazy. Wyboru moûna
  397. dokonaê  takûe  przez  wybór  odpowiedniego  pliku  z filerequesta
  398. dostëpnego w reqtools library.
  399.  
  400. 4)  zamieniê  mapë  klawiatury.   Podajâc peînâ ôcieûkë dostëpu do
  401. nowej  np:   'sys:devs/keymaps/d_pl'.   W  przypadku  nie  podania
  402. ôcieûki  dostëpu (ciâg pusty) w programie zostanie uûyta systemowa
  403. mapa   klawiatury.    Wyboru   moûna  dokonaê  takûe  przez  wybór
  404. odpowiedniego pliku z filerequesta dostëpnego w reqtools library.
  405.  
  406.  
  407. 5)    ustawiê   standard   kodowania   polskich   znaków   podajâc
  408. odpowiadajâce  kody  w  formie  szesnastkowej  dla  poszczególnych
  409. znaków w nastëpujâcej kolejnoôci.  Najpierw dla maîych ' â ê ë î ï
  410. ó ô ú û ' nastëpnie dla duûych ' ʠˠΠϠӠԠڠ۠'.
  411.  
  412. np:  'e2,ea,eb,ee,ef,f3,f4,fa,fb,c2,ca,cb,ce,cf,d3,d4,da,db'
  413.  
  414. w tym przypadku 'â' odpowiada kod e2
  415.                 'ê' odpowiada kod ea
  416.                 'ë' odpowiada kod eb
  417.                  itd...
  418.  
  419. Dla  przypomnienia  zamieszczam  poniûej  tabelë z kodami polskich
  420. znaków dla kilku popularnych systemów.
  421.  
  422. XJP    e6,e7,ea,ee,f1,f3,f5,fb,fe,c6,c7,ca,ce,d1,d3,d5,db,de
  423. PL    e2,ea,eb,ee,ef,f3,f4,fa,fb,c2,ca,cb,ce,cf,d3,d4,da,db
  424. Maz    86,8d,91,92,a4,a2,9e,a6,a7,8f,95,90,9c,a5,a3,98,a0,a1
  425. lat-2    a5,86,a9,88,e4,a2,98,ab,be,a4,8f,a8,9d,e3,e0,97,8d,bd
  426. DNH    89,8a,8b,8c,8d,8e,8f,90,91,80,81,82,83,84,85,86,87,88
  427.  
  428. Dodatkowo w wersji programu 1.25 moûna standard kodowania polskich
  429. znaków  wybraê z dostëpnego menu w którym jest juû zdefiniowane 21
  430. owych  standardów,  popularnych  z  róûnych  platform sprzëtowych.
  431. Dane do tych standardów kodowania zaczerpnâîem z strony www.
  432.  
  433. 6) ustawiê tablice znaków wedîug której bëdâ sortowane wyrazy, jak
  434. równieû  znaki  które  bëdâ  brane  pod  uwagë podczas sprawdzania
  435. wyrazów  z  poziomu  pracy  programu  w  trybie sprawdzania caîych
  436. tekstów.   W  przypadku gdy w tej tablicy znajdzie sië na przykîad
  437. znak  '-',  wszelkie  wyrazy poîâczone tym znakiem bëdâ sprawdzane
  438. jako caîoôê.
  439.  
  440. 6)  ustaliê  nazwy  skryptów  Arexx-owych które bëdâ wykonywane po
  441. przyciôniëciu  odpowiedniego  klawisza  funkcyjnego  od F1 do F10.
  442. Podajâc   peînâ  ôcieûkë  dostëpu  do  skryptu  dla  odpowiedniego
  443. klawisza  funkcyjnego.   Na  przykîad  dla  klawisza F10 podajemy:
  444. 'df0:rexx/GoTo_Ced.ced'.   Wyboru  moûna dokonaê takûe przez wybór
  445. odpowiedniego pliku z filerequesta dostëpnego w reqtools library.
  446.  
  447. 7) ustaliê czy program podczas szukania wyrazów ma rozróûniaê maîe
  448. od duûych liter.
  449.  
  450. 8) ustaliê czy podstawowa biblioteka programu ma byê zaîadowana do
  451. pamiëci  RAM,  zaîadowanie owej biblioteki do pamiëci RAM znacznie
  452. przyspiesza  pracë  programu,  jednakûe  naleûy wziâê pod uwagë iû
  453. biblioteka ta liczy obecnie okoîo 775 kB.
  454.  
  455. 9)  ustaliê  czy  okienko  programu  ma  pojawiaê  sië  na ekranie
  456. Workbench-a czy na ekranie znajdujâcym sië na samym wierzchu.
  457.  
  458. 10)   ustaliê   czy   program   ma   sortowaê   wyrazy  przed  ich
  459. wyôwietleniem.
  460.  
  461. 11)  wpisaê  hasîo  które  pozwoli  Ci na zapisywanie preferencji,
  462. hasîo te otrzymasz po uprzednim zarejestrowaniu programu u autora.
  463.  
  464.     Ustawione  przez  siebie  preferencje  moûemy  zapisaê  na
  465. dyskietkë systemowâ wciskajâc gadûet 'Zapisz'.
  466.  
  467.     Tylko  uûyê  w  dalszej  pracy  programu, wciskajâc gadûet
  468. 'Uûyj'.
  469.  
  470.     Ominâê dokonane zmiany, wciskajâc gadûet 'Pomiï'.
  471.  
  472.  
  473.                  Orto_Slownik a interfejs Arexx-a
  474.  
  475.  
  476.     Program   Orto_Slownik   zostaî  wyposaûony  w  tak  zwany
  477. interfejs  Arexx-a,  przy  pomocy tego interfejsu moûemy z poziomu
  478. skryptów  Arexx-owych sterowaê naszym programem, wymieniajâc z nim
  479. dane,  czy narzuciê programowi konkretne operacje do wykonania.  W
  480. tym  to  celu  program  tworzy  wîasny  port komunikacyjny nazwany
  481. 'Orto_Slownik',  przez  który  to  odbywa  sië  komunikacja z nim.
  482. Dodatkowo by moûna byîo komunikowaê sië z programem niezbëdne jest
  483. wyposaûenie  jego  w zbiór funkcji rozumianych przez niego samego,
  484. bowiem  serwer  arexx-a  tylko  nie rozumiane  przez siebie komendy
  485. przeôle do portu programu o podanej wczeôniej nazwie.
  486.  
  487.     W   przypadku   gdy  naraz  zostanie  uruchomionych  kilka
  488. programów   Orto_Sîownik,   kaûdy   z  nich  utworzy  wîasny  port
  489. komunikacyjny    o   wspólnej   nazwie   'Orto_Slownik'   lecz   z
  490. indywidualnym  indeksem zaleûnym od tego jako który z kolei zostaî
  491. uruchomiony.   W  przypadku  pierwszego  bëdzie  to  port o nazwie
  492. 'Orto_Slownik',  dla  drugiego  bëdzie  to  'Orto_Slownik_1',  dla
  493. trzeciego bëdzie to 'Orto_Slownik_2', itd...
  494.  
  495.     W  obecnej wersji programu obsîuga portu arexx-a nastëpuje
  496. jedynie z poziomu pracy programu w trybie bezpoôrednim.
  497.  
  498.            Peîna lista rozkazów wbudowanych w program.
  499.  
  500.  
  501. a)  SSEARCH  X  -  nakazuje  sîownikowi  wyszukanie w bibliotece
  502. wyrazów, ciâgu znaków zawartych w zmiennej X, rezultatem wykonania
  503. wyûej  wymienionej  komendy  jest  liczba  umieszczana  w zmiennej
  504. arexx-sowej  RESULT,  i  odpowiada jej iloôê wyrazów które zostaîy
  505. znalezione.   Jeûeli  nie  zostaî  znaleziony  ûaden wyraz wówczas
  506. zmienna RESULT zawiera 0.
  507.  
  508. b)  SADDWORD  X  -  powoduje  dodanie  ciâgu  znaków zawartych w
  509. zmiennej X od biblioteki wyrazów.
  510.  
  511. c)  SOKAY1  X  -  wyôwietla  komunikat o treôci takiej jaka jest
  512. zawarta w zmiennej X, oraz oczekuje na jego potwierdzenie.
  513.  
  514. d)  SOKAY2  X - powoduje wyôwietlenie komunikatu o treôci takiej
  515. jaka  jest zawarta w zmiennej X, oraz oczekiwanie na jednâ z dwóch
  516. odpowiedzi.   Rezultatem  wykonania wyûej wymienionej komendy jest
  517. znak umieszczany w zmiennej arexx-sowej RESULT, i odpowiada mu 'Y'
  518. jeôli  podano  jako  odpowiedz  'Tak'  lub  'N'  jeôli podano jako
  519. odpowiedú 'Nie'.
  520.  
  521. Uwaga  -  komunikat  ten dla ORTOKAY1 i ORTOKAY2, moûe skîadaê sië
  522. maksymalnie  z  4  linijek tekstu po 27 znaków, kaûda linijka musi
  523. byê oddzielona od nastëpnej znakiem koïca linii (0a).
  524.  
  525. e) SGETSTRING X - wyôwietla komunikatu o treôci takiej jaka jest
  526. zawarta  w  zmiennej  X,  oraz oczekuje na wpisanie ciâgu znaków z
  527. klawiatury.
  528.  
  529. Uwaga - W przypadku nie podania opcjonalnego parametru X, zostanie
  530. przyjëty  za  domyôlny  'Podaj tekst'.  Komunikat ten moûe skîadaê
  531. sië w tym przypadku z 2 linijek tekstu po 27 znaków, kaûda linijka
  532. musi byê oddzielona od nastëpnej znakiem koïca linii (0a).
  533.  
  534. f)  SSIZEMIN  -  zmniejsza  okienko  sîownika  do  postaci belki
  535. tytuîowej.
  536.  
  537. g)  SSIZEMAX  -  zwiëksza  okienko sîownika do peînych wymiarów,
  538. dziaîanie odwrotne do ORTSIZEMIN.
  539.  
  540. h) SGOTOFRONT - wysuwa okienko sîownika przed pozostaîe okienka.
  541.  
  542. i) SGOTOBACK - chowa okienko sîownika za pozostaîe okienka.
  543.  
  544. j)  SREQUESTOFF - zabrania sîownikowi wyôwietlania komunikatów z
  545. wnëtrza samego programu.
  546.  
  547. k) SREQUESTON - zezwala sîownikowi na wyôwietlanie komunikatów z
  548. wnëtrza samego programu.
  549.  
  550. Zastosowanie  2  powyûszych  komend  przedstawië  na  przykîadzie:
  551. zaîóûmy   iû   nakazujemy   sîownikowi   przez  odpowiedni  skrypt
  552. arexx-sowy  odszukanie ciâgu 'qwertz', sîownik po nie odnalezieniu
  553. owego  ciâgu  wyôwietliîby  automatycznie komunikat z pytaniem czy
  554. chcemy  ten  ciâg dodaê do sîownika.  Jeûeli chcemy by sytuacja ta
  555. nie  miaîa miejsca uûywamy komendy SREQUESTOFF, która to zabroni
  556. wyôwietlenia  owego  komunikatu z wnëtrza programu, by na przykîad
  557. wîaôciwa decyzja mogîa byê podjëta z poziomu skryptu.
  558.  
  559. j)  SSETPLCODE  X - ustawia w sîowniku kody dla polskich znaków,
  560. kody  te  muszâ  byê zapisane w formie szestnaskowej oddzielone od
  561. siebie przecinkiem w nastëpujâcej kolejnoôci.  Najpierw dla maîych
  562. '  â  ê  ë  î ï ó ô ú û' nastëpnie dla duûych ' ʠˠΠϠӠԠڠÛ'.
  563. np:
  564.  
  565. OrtSetPlCode 'e2,ea,eb,ee,ef,f3,f4,fa,fb,c2,ca,cb,ce,cf,d3,d4,da,
  566.           db'
  567.  
  568. k)  SGETPLCODE  -  pobiera  ze  sîownika  ustawienie  kodów  dla
  569. polskich znaków.
  570.  
  571. l) SACTIVATEWINDOW - uaktywnia okienko Orto_Slownika.
  572.  
  573. m)  SWORDTORAM  -  kopiuje  bibliotekë  sîownika do pamiëci RAM,
  574. operacja  ta  znacznie  przyspiesza  dziaîanie  programu, jednakûe
  575. skopiowane  dane zajmujâ okreôlony obszar pamiëci, w zaleûnoôci od
  576. ich rozmiaru.
  577.  
  578. n) SDELWORDFROMRAM - usuwa dane z pamiëci RAM.
  579.  
  580. o)   SGOTOFIRSTSCREEN   -   przenosi  okienko  programu  na  ekran
  581. znajdujâcy sië na samym wierzchu.
  582.  
  583. p) SGOTOWBSCREEN - przenosi okienko programu na ekran WORKBENCH-a.
  584.  
  585. r) SQUIT - powoduje zamkniëcie sîownika.
  586.  
  587. Dodatkowo dostëpne w wersji 1.25 programu komendy to
  588.  
  589. s) SLOADFROMCLIP  -  kopiuje  tekst  z  clipboardu  do  programu.
  590.  
  591. t) SSAVETOCLIP - kopiuje caîy tekst z programu do clipboardu.
  592.  
  593. Dodatkowo  na  dyskietce  z programem w katalogu rexx znajdujâ sië
  594. przykîadowe  skrypty  w  arexx-ie.  Wywoîania skryptu do wykonania
  595. moûemy  dokonaê  z  poziomu  pracy programu w trybie bezpoôrednim,
  596. naciskajâc  odpowiedni  klawisz  funkcyjny.   Lub  z  poziomu  CLI
  597. podajâc RX wraz ze ôcieûkâ dostëpu do tego skryptu.
  598.  
  599.     Nazwy  skryptów umieszczonych w katalogu rexx z opisem ich
  600. dziaîania:
  601.  
  602. GoTo_Slownik.ced   -  skrypt  ten  powoduje  uaktywnienie  okienka
  603. Orto_Sîownika  bez  potrzeby  robienia  tego  przy  pomocy myszki.
  604. Skrypt ten naleûy zainstalowaê w edytorze tekstów, wówczas to przy
  605. pomocy  jednego  klawisza  bëdziemy  mogli  przejôê  z  edytora do
  606. Orto_Sîownika.
  607.  
  608. GoTo_Ced.ced  -  skrypt  ten  powoduje uaktywnienie okienka CED-a.
  609. Skrypt ten instalujemy w Orto_Sîowniku.
  610.  
  611. Check_Word.ced   -   skrypt   ten   powoduje   przesîanie   wyrazu
  612. znajdujâcego sië pod kursorem w edytorze tekstów, do Orto_Sîownika
  613. celem jego sprawdzenia.
  614.  
  615. Check_Block.ced  -  skrypt  ten  powoduje  przesyîanie  wyrazów  z
  616. zaznaczonego  bloku w edytorze tekstów, do Orto_Sîownika celem ich
  617. sprawdzenia.
  618.  
  619. CopyToSlownik.ced  -  skrypt  ten  przenosi  caîy  tekst edytowany
  620. aktualnie  w  edytorze  Ced do programu Sîownik poprzez Clipboard.
  621. Nastëpnie  uaktywnia  okienko  Sîownika,  wystarczy  potem wcisnâê
  622. klawisz  'E'  i juû moûemy sprawdzaê ten tekst z poziomu Sîownika.
  623. Uwaga  -  wymaga  clipboard.device (chyba tyklo od kickstaru 2.0 w
  624. góre dostëpne) oraz Ced-a w wersji conajmniej 3.5.
  625.  
  626.  
  627. Przykîad prostego skryptu arexx-owego.
  628.  
  629. /* sîownik demo */
  630.  
  631.  
  632.   Options Results
  633.   Address 'Orto_Slownik'
  634.   SGoToFront
  635.   SSizeMax
  636.   SRequestOff
  637.   SSetPlCode 'e2,ea,eb,ee,ef,f3,f4,fa,fb,c2,ca,cb,ce,cf,d3,d4,da
  638.             ,db'
  639.   SGetString 'podaj coô tam'
  640.   target = result
  641.   SSearch target
  642.   if result = '0' then
  643.   do
  644.     SOkay2 'Nie znaleziono wyrazu' || 'a'X || target || 'a'X ||
  645.          'Czy dodaê go do sîownika'
  646.     if result = 'Y' then OrtAddWord target
  647.   end
  648.   else SOkay1 'znaleziono ' || result || ' wyraz(ów)'
  649.   SSizeMin
  650.   SGoToBack
  651.   SRequestOn
  652.  
  653.  
  654.     Sîowniczek uûytych w opisie angielskojëzycznych wyrazów.
  655.  
  656.  
  657. GADGET  (gadûet)  -  sîowo  to  oznacza,  element graficzny mogâcy
  658. zawieraê  równieû  tekst, na którym to wciôniëcie przycisku myszki
  659. wywoîuje   okreôlonâ   reakcjë   programu.   W  naszym  konkretnym
  660. przykîadzie  bëdâ to pola na ekranie obrysowane dwu kolorowâ ramkâ
  661. sprawiajâcâ efekt trójwymiarowoôci.
  662.  
  663. REQUEST  - z angielskiego ûâdaê.  Z zaîoûenia okno pojawiajâce sië
  664. w  lewym  górnym  rogu ekranu, zawierajâce tekst oraz gadûety, np.
  665. okno  ûâdajâce  wîoûenia dyskietki ('Plase replace volume...').  Z
  666. biegiem  czasu, uûytkownicy Amigi zaczëli jednak stosowaê të nazwë
  667. szerzej,  w  stosunku do niemal wszystkich okien otwieranych przez
  668. programy w ôciôle okreôlonym celu, na przykîad wyboru pliku.
  669.  
  670. WORKBENCH  -  ekran  systemowy  który  otwiera  sië  po  wczytaniu
  671. systemu,  na nim to umieszczone zostajâ ikonki napëdów, dyskietek,
  672. na  nim to teû otwierajâ sië okienka z ikonkami katalogów, plików.
  673. Praca  w  Workbench-u  przypomina  pracë  w dos-ie z tâ róûnicâ iû
  674. operujemy myszkâ a nie klawiaturâ.
  675.  
  676. CLI  -  Command  Line  Interface - program przyjmujâcy polecenia z
  677. klawiatury, przez okno "AmigaDOS".
  678.  
  679. RAM (Random Access Memory) - pamiëê o dostëpie swobodnym, pamiëê o
  680. dostëpie bezpoôrednim.
  681.  
  682. CHIP   RAM  -  pamiëê  do  której  majâ  dostëp  wszystkie  ukîady
  683. specjalizowane  Amigi w tym równieû procesor.  W pamiëci tej muszâ
  684. byê  zlokalizowane dane graficzne, dzwiëkowe, bufor stacji dysków.
  685. Procesor  pracujâc  jedynie  z pamiëciâ CHIP RAM uzyskuje 70% swej
  686. prëdkoôci poniewaû musi on oczekiwaê na dostëp do niej wówczas gdy
  687. korzysta z niej inny specjalizowany ukîad Amigi.
  688.  
  689.  
  690.     W  programie  wykorzystano algorytm sortowania 'Szybkiego'
  691. podany w ksiâûce Atari Basic.
  692.  
  693.     Sîowniczek  uûytych  w  opisie angielskojëzycznych wyrazów
  694. opracowano  na podstawie ksiâûki 'Po prostu Amiga' Andrzeja Bobka,
  695. Bartosza Smaga.
  696.  
  697.     Wiele  usprawnieï  natury  programistycznej  w  programie,
  698. powstaîo  na  podstawie  artykuîów  "C  dla  kaûdego"  zawartych  w
  699. miesiëczniku AMIGA(r) autorstwa Kamila Iskra oraz Dariusza Ûbik.
  700.  
  701.  
  702. ps:   Specialne  pozdrowionka  dla koleûanek, znajomych z uczelni,
  703. kanaîów IRC-owych (#AmigaPL w szczególnoôci). :-)
  704.  
  705.  
  706.